home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / answers / comp / ibm-rt-faq / aix-v2 / software / part2 < prev    next >
Internet Message Format  |  1994-04-03  |  44KB
  1. Path: bloom-beacon.mit.edu!hookup!news.moneng.mei.com!howland.reston.ans.net!europa.eng.gtefsd.com!emory!swrinde!news.uh.edu!lobster!antimatr!faq-rt
  2. From: faq-rt@antimatr.hou.tx.us (Mark Whetzel)
  3. Newsgroups: comp.sys.ibm.pc.rt,comp.unix.aix,comp.answers,news.answers
  4. Subject: COMP.SYS.IBM.PC.RT: AIX V2 FAQ - Software questions, Part 2 of 3
  5. Summary: This posting contains Frequently Asked Questions (and their answers)
  6.          on software issues when using AIX V2.2.x on IBM RT (615x) computers.
  7.          Plus general information, hints and tips.
  8. Keywords: IBM RT PC software FAQ 6150 6151 6152 AIX VRM AOS MACH PICK
  9. Message-ID: <ibmrt_aixv2s2_765425273@antimatr.hou.tx.us>
  10. Date: 4 Apr 94 02:08:33 GMT
  11. Expires: 17 May 94 02:07:53 GMT
  12. References: <ibmrt_aixv2s1_765425273@antimatr.hou.tx.us>
  13. Sender: markw@antimatr.hou.tx.us
  14. Reply-To: aix-rt@antimatr.hou.tx.us
  15. Followup-To: comp.sys.ibm.pc.rt
  16. Lines: 963
  17. Approved: news-answers-request@MIT.Edu
  18. Supersedes: <unknown>
  19. Xref: bloom-beacon.mit.edu comp.sys.ibm.pc.rt:1496 comp.unix.aix:23021 comp.answers:4431 news.answers:17303
  20.  
  21. Archive-name: ibm-rt-faq/aix-v2/software/part2
  22. Last-modified: Sat Mar 12 07:08:12 CST 1994
  23. Version: 1.1
  24.  
  25. Frequently Asked Questions for:  AIX V2.2.1 on IBM RT systems.
  26.                                  System Software topics for AIX/RT.
  27.                                  Part 2 of 3 parts.
  28.  
  29. The AIX V2 FAQ currently consists of EIGHT parts in 5 topic areas:
  30.  
  31.      AIX V2 FAQ Index and acknowledgements
  32.      AIX V2 OS Specific hardware issues - in one part (currently).
  33.      AIX V2 Software questions - in three parts. (This FAQ)
  34.      AIX V2 Problem Questions and answers - two parts.
  35.      AIX V2 Porting software notes - in one part currently.
  36.  
  37. See the AIX V2 FAQ index posting for a complete index of the AIX FAQ postings.
  38.  
  39. ================================================================================
  40.  
  41. 2.0   Software questions (continued).
  42.  
  43. S.13 - How to managage serial ports.
  44.  
  45.       NOTE: Printer/plotter serial devices are automatically defined
  46.     with port and speed parameters when adding that device type
  47.     under the printers menu.  For more information about adding
  48.         printers see sections H.14 and S.28. The following is for
  49.         terminal, modem and other serial device types.
  50.  
  51.       The devices command is used to add, change and delete serial port
  52.       settings, and how the getty will operate with that serial port.
  53.  
  54.       The devices command will automaticlly detect any attached serial port
  55.       hardware and present them in the "Following adapters are available" menu.
  56.  
  57.         devices 
  58.           add
  59.            ttydev
  60.              tty
  61.                <..Following adapters available menu displayed> 
  62.                  < a new panel comes up showing terminal type>
  63.     
  64.       Most serial ports will need other information such as speed,
  65.       parity, and stop bit settings, but this first panel presented does
  66.       not have them.  Fill in the displayed settings with your requirements
  67.       as show on this menu.  Some common options:
  68.  
  69.          'ae' = true (meaning enable always, more on this later).
  70.          davm = 1  (1=modem, 0=direct attached)
  71.          tt   = to any string matching /usr/lib/terminfo available terminal 
  72.                 type most likely to call your system.
  73.         If unknown, set it to 'dumb'.
  74.  
  75.       The critical part of this panel is the 'ae' option.   Set it to 'true'
  76.       (meaning 'enable') for a dial-in only port.  A getty task will be
  77.       started continually waiting for logins.  When 'ae' is set to 'share'
  78.       or 'delay' the getty operation is altered for bi-directional (call-in
  79.       and call-out), operation.  By using 'delay' this will setup the getty
  80.       to run similar what other UNIX systems call a 'uugetty'. 
  81.       With 'ae' set to 'false' no getty will be started for this serial port,
  82.       and it may be used directly by application programs for I/O purposes.
  83.       Application programs or system functions (cu, ate, uucico, ect..) may
  84.       use the serial port without at anytime.
  85.    
  86.       Press enter to bring up a yes/no question about changing more
  87.       options.. enter 'yes'.
  88.   
  89.       A Larger panel will appear allowing you to choose the baud rate, and
  90.       other serial settings, such as stop bits, xon/xoff and other 
  91.       common selections for serial ports.
  92.       Some common options for attaching a modem:
  93.           bpc  =  bits per character
  94.           rts  =  speed of the port
  95.           sns  =  false  (switched or dial-in port)
  96.           aa   =  true   (auto answer)
  97.           pt   =  parity type (odd,even,none,mark,space)
  98.           nosb =  number of stop bits.
  99.  
  100.       Default any options you don't clearly understand.
  101.  
  102.       The devices command will change the system so that the getty for the
  103.       port will be started each time the system is booted.  To change the
  104.       status of the getty while booted and only for the current life of
  105.       this IPL, use the pstart, pdisable, penable or pdelay commands to
  106.       change the port status to the desired state. Issuing the 'pstart'
  107.       command with no options will display all current tty port status.
  108.  
  109.         *  penable  - causes the getty to run all the time, and it will
  110.            present a login banner when the port detects carrier, and
  111.            modem ready.  The 'penable' command also keeps the port locked
  112.            all the time.  This command changes the port operation to be the
  113.            same as the options devices panel 'ae' set to 'true'.
  114.  
  115.         *  pdelay  - causes the getty to raise DTR, and wait for carrier
  116.            before presenting the login herald, AND to WAIT to 'lock' the
  117.            port from other users (if necessary) UNTIL some characters are
  118.            actually recived on the port. Some systems call this a 'uugetty'.
  119.        This command changes the port operation to be the same as the
  120.            devices panel 'ae' set to 'delay'.
  121.  
  122.         *  pshare  - is similar to pdelay, but it locks the port immediately
  123.            on recipt of carrier. (least useful of the options)
  124.        Same as the devices panel 'ae' set to 'share'.
  125.  
  126.         *  pdisable - causes the getty to be halted for this port, freeing 
  127.            the port for usage by other programs.  DTR will be dropped,
  128.            and if a modem is attached and configured correcty, will hang up
  129.            any user dialed in, and prevent the modem from answering the line.
  130.        Same as the devices panel 'ae' set to 'false'.
  131.            To stop ALL tty ports at once, use 'pdisable -a'.
  132.  
  133.       NOTE: A few notes on the 'pro' (protocol) parameter on the devices menu.
  134.             Protocol has three diffent settings:
  135.               cdstl  = Connect Data Set To Line.
  136.                        [ I have not figured out what this one does - MW ]
  137.               dc     = Direct Connect = CTS lead examined for pacing 
  138.                        (on the RT native port, Pin #8).
  139.               dtr    = Data Termnal Ready = DTR lead examined for pacing
  140.                        (on the RT native port, Pin #2).
  141.  
  142.             Depending on the cable attached, the 'pro' keyword can
  143.             have a radically different meaning.  For the modem cable,
  144.             and to use 'hardware' handskake instead of xon/xoff set the
  145.             'protocol' to 'dc' and 'ixp' to 'false' on the devices port panel.
  146.             That cable has the CTS lead conneted to the CTS pin on the
  147.             25 pin modem side of the cable. This will utilize RTS/CTS pacing.
  148.  
  149.             When using the serial printer cable, the CTS pin on the RT side
  150.             is connected to 'DTR' on the printer.  Some printers use the
  151.             DTR lead to control hardware pacing, and if so, you should have
  152.             'pro = dc' for this to work correctly, instead of 'pro = dtr'.
  153.             [Confusing, yes? - MW]
  154.  
  155.       Unique to AIX/RT is the '/etc/ports' file.  Entries in this
  156.       file control various aspects of serial ports.  This file is
  157.       a stanza format file.  There is one stanza for each device 
  158.       port, and two special stanzas 'default' containing defaults for
  159.       all ports, and 'console' meaning the system hft console.
  160.       The file has the following format:
  161.  
  162.           device:
  163.                option = value
  164.  
  165.       The following options can be of assitance with UUCP setup
  166.         lock=          true.  This stanza is CRITICAL for a shared
  167.                            dial-in/dial-out bi-directional use port.  
  168.                            No command adds this stanza, and it is not
  169.                            added by default, but without it, port locking
  170.                            will not be handled coorecty amoung the
  171.                            getty,cu,ate and uucico programs.
  172.             enabled =      Set by devices to the value of the 'ae' field.
  173.                            values: true, delay, share, or false. Corresponding
  174.                            to penable, pdelay, pshare or pdisable.
  175.             speed=         Initial port speed.  Not documented is the fact
  176.                            that a comma delimited list of speeds is availabe
  177.                            and that getty will rotate thru the list presenting
  178.                            the hearald in the specified speed on recipt of 
  179.                            a 'break' signal.
  180.         parity=        parity to use, set by devices command,
  181.                            values: odd,even,none,mark and space.  Can also
  182.                            be a comma delimited list like 'speed' above.
  183.            
  184.             hearld=        The chracter string presented by the getty for
  185.                            a login greeting.
  186.         term=          Sets the string that the TERM envionment variable
  187.                            will be set to upon successful login.
  188.         logmodes=      Port characteristics during login processing.
  189.         runmodes=      Port characteristics set after login complete.
  190.  
  191.    Here is an example Telebit trailblazer T1600 setup that seems to work
  192.    with the RT UUCP, using hardware flow control. 
  193.    
  194.    ==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==
  195.    Submitter: herb@ajfcal.UUCP    
  196.    Date: 21 May 91 13:40:50 GMT
  197.  
  198.    [ initial netnews discussion on UUCP troubles deleted - MW ]
  199.    Sounds like you're having flow control problems... I just overcame
  200.    the same thing when I upgraded the OS on my RT.. (CorrSrvc 1773).
  201.    I just couldn't get hardware flow control working to save my life
  202.    but this weekend I sat down for a couple of hours and got it working
  203.    with my "DCA Fastlink" (Trailblazer Clone).
  204.  
  205.    In "devices", I have:
  206.     pro dc
  207.     ixp false
  208.     dvam 0       [ I think he would have less trouble with dvam=1 - MW ]
  209.     sns false
  210.     aa false
  211.  
  212.    and in the telebit, I have:
  213.  
  214.    E0 F1 M0 Q1 T V1 X3     Version AA3.00-AB3.00
  215.    S00=001 S01=000 S02=043 S03=013 S04=010 S05=008 S06=002 S07=060 S08=002
  216.    S09=006 S10=007 S11=070 S12=050 
  217.    S45=000 S47=004 S48=001 S49=000
  218.    S50=000 S51=005 S52=002 S53=001 S54=003 S55=003 S56=017 S57=019 S58=002
  219.    S59=000 S60=000 S61=099 S62=003 S63=001 S64=000 S65=000 S66=001 S67=000
  220.    S68=002 S90=000 S91=000 S92=000 S95=000 
  221.    S100=000 S101=000 S102=000 S104=000 
  222.    S110=255 S111=255 S112=001 
  223.    S121=000 
  224.   
  225.    Other Pertinent information: 6150-25, IBM 4 port async, and standard
  226.    IBM Modem cable.
  227.  
  228.    There's still a problem with Carrier Detect and getty... It seemed to
  229.    a choice between having hardware flow control or having getty work
  230.    right...  But if you're using it to dial out only, then you shouldn't
  231.    have to worry about that...  
  232.    ==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==
  233.  
  234. ------------------------------
  235. S.14 - How to add user accounts to AIX V2.
  236.       Also covers the various /etc/security stanza file contents.
  237.  
  238.       To create or update a group or a user, you must have superuser
  239.       authority. Use the "users" or "addusers" command.
  240.       Example:
  241.          # users
  242.          > a g groupname          add a group
  243.          > c g groupname          change a group
  244.          > a u username           add a user
  245.          > c u username           change a user
  246.          > ?                      help
  247.          > q                      quit
  248.  
  249.       The AIX/RT system uses a secondary security system similar to
  250.       some systems with a shadow password file.  The /etc/passwd file
  251.       and /etc/group files do not contain the actual password.  Instead an
  252.       explanation mark (!) is used as a place holder indicating that the
  253.       password is located in the /etc/security directory in the file of
  254.       the same name. 
  255.  
  256.       WARNING: At some update levels of AIX/RT, the 'sysck' command,
  257.          called by the 'adduser' command can cause password file corruption
  258.          if any of the files have been edited by hand.  The sysck comand
  259.          is supposed to verify that the date/time stamps on on the
  260.          /etc/passwd and /etc/security/passwd files match and that the
  261.          internal stanzas are matching between the various files in
  262.          the /etc/security directory.  The sysck command attempts to
  263.          modify the /etc/security/passwd file to correct any tampering. 
  264.          This modification can cause corruption of the /etc/security
  265.          stanzas can make your system unable to be logged into. 
  266.          Systems earlier than 2704 do not have the problem, and 
  267.          systems with 2706 on or later do not have the problem.
  268.  
  269.       An AIX/RT password entry can have the following parts:
  270.  
  271.          george:!:200:1:User George/600000;description:/u/george:/bin/sh
  272.          ^      ^ ^   ^ ^           ^      ^            ^        ^
  273.          A      B C   D E           F      G            H        I
  274.  
  275.       Description:
  276.          A - Username
  277.          B - Password place holder.  An asterix (*) will make the password
  278.              invalid.  If null, no password is assigned, but the 'sysck'
  279.              program will not allow this.  See the /etc/security/passwd
  280.              file description for more information.
  281.          C - User id number. Numbers below 100 are reserved for system use.
  282.              User account numbers below 20 are privlidged users, and are
  283.              allowed logins at any time regardless of system load, maxusers,
  284.              or other system restrictions.
  285.          D - Group number.
  286.          E - Name field
  287.          F - Optional ulimit size (update level 2704 or greater) 
  288.              from the 'filesize' adduser field.
  289.              Maximum user file size in 512 byte blocks.  If this field is
  290.              omitted, the preceeding slash (/) must be omitted.
  291.          G - Siteinfo field contents. NOTE: A colon in this field is NOT
  292.              allowed.  If this field is omitted the preceeding semicolon (;)
  293.              must also be omitted.
  294.          H - Home directory.  As installed AIX defaults the home directory
  295.              to the /u filesystem.  Any valid filesystem may be used for
  296.              home directories.
  297.          I - Initial program to execute.  Maximum size 4096 characters and
  298.              14 parameters.
  299.  
  300.       The /etc/security directory contains several stanza files that 
  301.       further control the user login process.
  302.  
  303.             audit       - directory containing audit subsystem control files.
  304.             config      - stanza file to control login operations.
  305.             group       - current shadow group file.
  306.             ogroup      - backup copy of shadow group file created by 
  307.                           the adduser command before the last change.
  308.             grpchk      - executable program to verify group file.
  309.             passwd      - current shadow password file. 
  310.             opasswd     - backup copy of shadow passwd file created by
  311.                           the adduser command before the last change.
  312.             pwdchk      - executable program to verify password file.
  313.             sysck.cfg   - configuration file for the sysck command.
  314.            
  315.       The /etc/security/passwd file is a stanza form file with one
  316.       stanza for each user.  An example is like this:
  317.  
  318.             guest:
  319.                 password = *
  320.                 restrictions = nologin
  321.             
  322.             george:
  323.                 password = xxyy123456789
  324.                 lastupdate = 733115124
  325.             
  326.    Valid stanza fields are:
  327.        password=      The users encrypted password.  If field is missing or
  328.                       NULL, the account has no password.
  329.  
  330.        lastupdate=    The date on which the user last changed the password.
  331.                       The value is expressed as the number of seconds since
  332.                       the epoch (Jan 1, 1970).
  333.                       Note: If password ageing is in use, setting this field
  334.                             to zero forces a password change immediately on
  335.                             next user login.
  336.  
  337.        restrictions=  The restrictions stanza controls how the account will
  338.                       be handled.  One benefit of account control allows you
  339.                       to leave the password unchanged for an account, yet
  340.                       still prohibit its use.  Valid values are:
  341.  
  342.                       nologin - Disallow login processing for this account
  343.                                 (telnet and rlogin will not work).
  344.                                 An illegal password entry of '*' also makes
  345.                                 it impossible to login.  However, remote
  346.                                 shell 'rsh' is still allowed and 'su - userid'
  347.                                 is still allowed.
  348.                       nouse   - Account is completely disabled.
  349.                                 All login and use of the account is blocked,
  350.                                 including 'su' and 'cron'.
  351.                       nopw    - account is exempt from password ageing.
  352.                       notsh   - Trusted shell use is not allowed.
  353.  
  354.                       These may be combined such as "nologin,nopw".
  355.  
  356.        auditclasses=  This entry is used with the audit subsystem, and
  357.                       is the initial audit class for this user.  The 'audit'
  358.                       command updates this field.
  359.  
  360.       The /etc/security/config file is a stanza form file with one
  361.       stanza for different elements of AIX/RT security.
  362.  
  363.       One of the 'config' stanzas control password usage and aging.
  364.  
  365.            password:
  366.                maxage = 0
  367.                minage = 0
  368.                minalpha = 0
  369.                minother = 0
  370.                mindiff = 0
  371.                maxrepeat = 8
  372.  
  373.        Valid config entry 'password' stanza fields are:
  374.        maxage=      Maximum age in weeks of a valid password.
  375.        minage=      mininum age in weeks, before a change of a password
  376.                     is allowed.
  377.                     NOTE: password CANNOT be changed until minage is reached
  378.                           if it is non-zero.
  379.        minalpha=    Minimum number of alphabetic characters in a password.
  380.        minother=    Maximum number of numeric or special characters in password.
  381.        mindiff=     Minimum number of characters to be different from the
  382.                     old password.
  383.        maxrepeat=   Maximum number of identical consecutive characters to
  384.                     allow in a valid password.
  385.     
  386. ------------------------------
  387. S.15 - 6157 1/4" tape drive special file names.
  388.  
  389.     Due to the hardware design of the standard 6157 tape adapter, only
  390.     one adapter can been installed in one RT system.  However..
  391.     that one drive has 4 different device names:
  392.  
  393.     /dev/rmt0    normal tape device name, rewind on close.
  394.     /dev/rmt4    NO rewind on close.
  395.     /dev/rmt8    retension tape on open and rewind on close.
  396.     /dev/rmt12    retension tape on open, NO rewind on close.
  397.  
  398.     Note: If the NO rewind device name is used with read, after an 
  399.           open completes, AND an application starts reading, the tape
  400.           will be positioned to the EOT side of the next filemark by
  401.       close processing.
  402.  
  403. ------------------------------
  404. S.16 - UUCP setup and management.
  405.  
  406.    The AIX/RT system uses the HoneyDanBer variation of UUCP, or BNU
  407.    (Basic Networking Utility) as the facility is called.  IBM has made
  408.    very little change of the BNU facility, however, the way that AIX/RT
  409.    controls serial ports requires a few changes.
  410.   
  411.    The suporting IBM documentation is located in the "Managing the AIX
  412.    Operating System" manual number SC23-2008, Chapter 9. 
  413.  
  414.    An excelent reference book is the "Managing UUCP and Usenet" book
  415.    by O'Reilly & Associates ISBN 0-937175-93-5.   This book is an excelent
  416.    UUCP reference, but AIX/RT requires a few special notes:
  417.  
  418.       1) All the control files for BNU are located in '/usr/adm/uucp'
  419.          instead of the '/usr/lib/uucp' or '/etc/uucp' directories.
  420.  
  421.       2) Login accounts created for UUCP should be in group 'uucp'.
  422.          I like to use uid numbers between 100 and 199 for uucp use.
  423.          (Uids over 200 normally start the standard user range of uids).
  424.          The gid 5 is the uucp group, and the accounts should be in that group.
  425.  
  426.       3) Port AND getty control is done via the 'devices' command,
  427.          or the port control commands 'pstart,pdelay,pshare,pdisable 
  428.          and penable'. See section S.13 on serial port managment.
  429.          There is no '/etc/inittab' (as SYSV) or '/etc/ttys' (BSD/Xenix),
  430.          or '/etc/gettytab' (SunOS).  AIX/RT has a unique file called
  431.          '/etc/ports'.  That file is discssed in more detail below.
  432.  
  433.       4) Serial devices have two names for each port that are quite 
  434.          helpful, for example the first serial port is called tty0,
  435.          and has the following device special files:
  436.  
  437.             /dev/tty0    -  standard port, and open blocks until carrier
  438.                             detect is true.
  439.             /dev/ltty0   -  Has the equivlent of 'clocal' set and allows
  440.                             open to complete without carrier.
  441.  
  442.          When setting up the 'Devices' control file, use the /dev/ltty#
  443.          entry so that uucico can open the port and be able to send dial
  444.          string characters.  This is critical, as the modem MUST be setup
  445.          to only have CD (Carrier Detect) true only when a real carrier is
  446.          detected from the remote end.  Most hayes compatible modems when
  447.          shipped from the factory have CD forced true at all times.  This
  448.          is trouble for uucico, as it cannot detect when a session has
  449.          failed, and when to hangup.
  450.  
  451.       5) To use the RT to program a modem soft switches, add the tty device
  452.          with the modems default port speed and parity, ect...
  453.          Edit the /usr/adm/uucp/Devices file and uncomment or add an
  454.          entry called 'Direct'. 
  455.                # ---A direct line so 'cu -ltty0' will work
  456.                # Direct tty0 - 9600 direct
  457.                Direct ltty0 - 2400 direct
  458.  
  459.          Then use 'cu -l ltty0' to connect using the cu command.  You can
  460.          now use cu to use the various 'AT' commands of the modems to 
  461.          program the modem.
  462.         
  463.          As different modems use different soft register values, be sure
  464.          to check your modem documentation for the proper values to use.
  465.          These register settings described below are for an ATI2400e modem
  466.          your modem should have equivlent settings for these functions. 
  467.          Some the common settings needed are:
  468.               S0=1   Number of rings to answer.. (If call out only, you
  469.                       can leave this to zero to never answer the phone.)
  470.               &E0    Echo off in command mode. NOTE: This will make command
  471.                      strings typed with cu not to be echoed back by the
  472.                      local modem. Use the cu flag '-h' to turn on programmed
  473.                      echo (half-duplex).
  474.               &C0    Carrier follows true carrier.
  475.  
  476.       6) See section S.13 for general serial port control and setup.  See
  477.          also Q.8 and Q.9 in the Questions section on additional notes on
  478.          speed settings and bi-directional ports. 
  479.  
  480.          The following /etc/ports options can be of assitance with getting
  481.          UUCP setup and operating correctly:
  482.         lock=          You MUST add 'lock=true'.  This stanza is CRITICAL
  483.                            for a shared dial-in/dial-out bi-directional use
  484.                            port.  No command adds this stanza, and it is not
  485.                            added by default, but without it, port locking
  486.                            will not be handled correctly amoung the
  487.                            getty, login, cu, ct and uucico programs.
  488.                            NOTE: The 'ate' command regardless of update level
  489.                            still does not understand shared use ports.  You
  490.                            MUST pdisable the port prior to using ate.
  491.             enabled=       Set by devices to the value of the 'ae' field.
  492.                            values: true, delay, share, or false. Corresponding
  493.                            to penable, pdelay, pshare or pdisable.
  494.             hearld=        You will most likely want to add this entry to
  495.                            shorten the login prompt.  The default stanza has
  496.                            a long string of newline characters, and this can
  497.                            confuse some uucico chat scripts. 
  498.    
  499. ------------------------------
  500. S.17 - Setting up networking on an RT running AIX V2.
  501.  
  502.       General steps needed:
  503.          - If not installed, install TCP/IP portion of OS.
  504.          - Install any VRM driver(s) needed.
  505.          - Add hardware adapter (token-ring, ethernet, X.25) to system.
  506.          - Define adapter to system with devices.
  507.          - Edit /etc/net to set IP address and interface characteristics.
  508.          - Edit /etc/hosts to set hostname to IP address association,
  509.            and if needed, domain name server address(s).
  510.          - Edit the /etc/rc.tcpip file for full system domain name (if needed),
  511.            and if necessary, static routes.  Uncomment needed services.
  512.          - Uncomment the startup of interfaces and networking line in the
  513.            file '/etc/rc.include' file.
  514.          
  515. ------------------------------
  516. S.18 - How to set up SLIP - TCP/IP over serial lines.
  517.  
  518.      Open for adoption and filling in.
  519.  
  520. ------------------------------
  521. S.19 - Configuring NFS on AIX V2.
  522.       - Different versions of NFS for AIX V2.
  523.       - Known unfixed problems with NFS 1.1 on AIX V2.
  524.       - Known unfixed problems with NFS 1.2 on AIX V2.
  525.  
  526.      Coming soon ??????
  527.  
  528. ------------------------------
  529. S.20 - Known outstanding problems with AIX V2, unfixed by IBM.
  530.  
  531.    Even with the final update disks applied to the AIX 2.2.1 system
  532.    there are some unfortunate bugs still lurking.  Some can be corrected
  533.    by replacing the offending code with Public Domain replacements.
  534.    Others will require more work for repair.
  535.  
  536.    * Opsys:
  537.      - ate command will not work on bi-directional ports.  Port must be
  538.        in a disabled state for it to open the serial port.
  539.      - syslog function call will not format variable parameters for more
  540.        than three variables.
  541.    * TCP/IP:
  542.      - named daemon is very old, based on BIND vX.X.
  543.      - With 'telnet' terminal type negoation is not always correct
  544.        after update 1773.  1779 corrects some of the problems, but not all.
  545.  
  546.     [ This section, unfortunately, will need some expansion.  Report your
  547.       bugs to me, and I'll see they get added to this list. -MW ]
  548.  
  549. ------------------------------
  550. S.21  What Non-IBM software was available.
  551.  
  552.    * Applix IA.
  553.    * Dyalog/APL.
  554.    * Interactive Systems INmail/INnet/FTP
  555.    * Interleaf Inc. Workstation Publishing system.
  556.    * INGRES DBMS
  557.    * Oracle DBMS
  558.    * RM/COBOL 
  559.    * RS/1
  560.    * Rabbit Systems NETWORK 3270-PLUS, and RJE-PLUS.
  561.    * Samna+
  562.    * Solomon Sstems SOLOMON III Accounting package.
  563.    * SQL/RT
  564.    * Sytos/6157 Tape Utilities.
  565.    * UNIRAS
  566.    * WordPerfect V4.2.
  567.  
  568.      [ If anybody has information on software vendors still activly 
  569.           selling or supporting their RT software I would like to expand
  570.       this section with that information. Phone numbers or
  571.           mail/E-mail addresses of companies. - MW ]
  572.  
  573. ------------------------------
  574. S.22 - Setting up and using the PC Simulator.
  575.  
  576.   * Getting DOS/pcsim ready:
  577.        1. Use the "installp" program to install the pcsim LPP.
  578.           For AIX 2.2.1, only the latest release level of pcsim 1.1.1
  579.           will function correctly.
  580.  
  581.        2. Prepare the DOS 3.1 diskettes and one empty diskette (1.2 MB)
  582.           IBM PC-DOS 3.3 will also work.
  583.  
  584.        3. Create the working environment:
  585.            - Create a simulator user (ex. simuser)  Or use an existing
  586.              non-root userid.
  587.  
  588.        4. Customize the simulator:
  589.            - login as simuser
  590.            - create a file to be used a the 'C:' drive by PC DOS:
  591.              touch cdrive
  592.            - type: pcsim
  593.            - fill out the selection menu
  594.              Make the 'PC virtual hard disk point to that created file
  595.              called 'cdrive'. 
  596.            - save your customization
  597.        
  598.        5. Start the simulator:
  599.            - put the DOS Start diskette in the top floppy drive.  This is
  600.              drive 'A:' to the simulator by default.
  601.            - select START on the pcsim menu
  602.              PC DOS will be loaded from the floppy at this point.  If the
  603.              boot fails, in true IBM PC flavor, you will be dropped into
  604.              the 'ROM' basic.
  605.            - If all goes well, the PC DOS prompt A> appears.
  606.        
  607.        6. Install DOS on the simulated hard disk:
  608.            - type FDISK to create a DOS partition.
  609.            - type FORMAT C:/S to format the DOS partition
  610.            - use the SELECT command to customize DOS
  611.              (for Germany: select 049 gr)
  612.              This step will require the empty diskette.
  613.            - create the DOS library (C: MKDIR DOS)
  614.            - copy the DOS diskette on the disk: copy a:*.* c:\DOS
  615.        
  616.        7. Reboot DOS from 'PC' virtual hard disk:
  617.            - remove any diskette from the diskette-drive
  618.            - reboot pcsim with <ctl>-<(right)alt>-<del>
  619.  
  620.     NOTE: if you use a color display, make sure to define a BLACK
  621.     background and a white foreground, and you won't have color problems!
  622.  
  623.   * Simulator devices
  624.        The PC Simulator supports:
  625.           - CGA, EGA and APA displays (incl. megapel)
  626.           - the serial ports
  627.  
  628.     There are two main rules to follow in dealing with simulator
  629.     devices which are not supported by AIX:
  630.  
  631.       1. The Simulator cannot support devices that share interrupt levels.
  632.       2. The Simulator does not support devices that use alternate DMA.
  633.  
  634.   * Simulator applications
  635.      The following is a short list of applications that have been tested
  636.      by IBM at the release of the simulator product.
  637.      [This was collected from some ORIGINAL IBM documentation, some 
  638.       of this information is now very out of date. - MW ]
  639.  
  640.         IBM DOS 3.3
  641.         IBM Displaywrite 4 Version 1.02
  642.         IBM Storyboard Plus Version 1.01, Update 01
  643.         dBase III Plus Version 1.1
  644.         Chartmaster Version 6.21
  645.         PFS: First Choice Version 2.01
  646.         Wordperfect Version 4.2
  647.         Lotus 1-2-3 Version 2.01
  648.         Microsoft Windows Version 2.03
  649.         Flight Simulator Version 2.0
  650.  
  651.   * Defining an adapter to AIX and PCSIM
  652.  
  653.       Allocating an adapter to the Simulator is a three step process:
  654.         - You define it to AIX using devices by adding a device of
  655.           type 'simdev', say simdev0.
  656.         - You define it to PCSIM using the simdev command. For example,
  657.           'simdev -a simdev0'.
  658.         - You ALLOCATE the device to a session using the -adev0 flag
  659.           from the command line when you start the Simulator or by
  660.           selecting dev0 from the list of devices you may allocate from
  661.           the menu.
  662.  
  663.     You will need to select a display for the Simulator to use in
  664.     addition to your allocated adapter. This is because the Simulator
  665.     needs to create a process to receive keystrokes.
  666.  
  667.     Only the later version 1.1.1 of the simulator supports an X-window
  668.     as a simulator display.
  669.  
  670.     You will need PC software that knows to drive that display adapter.
  671.  
  672.     Note: To verify that the adapter has been properly defined and allocated
  673.           you can use DEBUG to display adapter memory. For example:
  674.              C>DEBUG
  675.              -d c600:0
  676.              C600:0000  FF FF FF FF ...
  677.  
  678.    Define the adapter as described above and allocate it.
  679.    If the RT does not have the adapter present, you get a series of 'FF'
  680.    values when DEBUG reads from the I/O bus. When the adapter is present,
  681.    DEBUG would read whatever is in the video buffer on the adapter.
  682.  
  683.    NOTE: The Simulator maps PC segment registers either entirely to the
  684.    I/O Bus or entirely to virtual memory on the RT. If you ask
  685.    DEBUG to display from segment C5FF (d c5ff:0) you will get a
  686.    series of zeroes like '00 00 00 00 ...' and NOT what is on the
  687.    adapter. This means that PC software that reads or writes to
  688.    an allocated adapter must load a segment register with a value
  689.    in the range of the adapter (and not with a lower value expecting
  690.    to use a larger offset to get into the adapter memory).
  691.  
  692. ------------------------------
  693. S.23 - Features of the AIX bourne shell.
  694.  
  695.   * Path resolution function
  696.      The AIX Bourne shell has a builtin command called "type" which returns
  697.      the complete path of the evoked AIX function.
  698.  
  699.         Example: "type ls" -> "ls is /bin/ls"
  700.  
  701.   * Use of the HFT console command editing keys can make the bourne shell
  702.     easier to use.
  703.  
  704.      Use the command 'stty enhedit' to turn on the enhanced edit functions
  705.      of the hft console.  With this enabled, the cursor keys and
  706.      function keys F1 thru F3 perform command recall functions and
  707.      command line editing.
  708.         The function keys perform similar to the IBM PC DOS command
  709.         editing keys:
  710.         F1 - copy one character at a time from the last command buffer.
  711.         F2 - Search for the character in the command line that is      
  712.              pressed immediately after the F2 key.
  713.         F3 - copy command buffer to end of line.
  714.         delete - delete character out of the enhanced buffer, shifting 
  715.                  the command line one character to the left from the
  716.                  current cursor position, until end of line.
  717.         insert - turn on insert mode on the command buffer
  718.         up arrow, down arrow  - scroll forward or backward thru the
  719.                command buffer.
  720.         right arrow - functions like F1 key, copies on character at a time.
  721.  
  722.      NOTE: If you use the RT Graphics Development Toolkit
  723.            "stty enhedit" interferes with the way VDI does mouse input.
  724.            You should then use "stty -enhedit" to de-activate the enhanced
  725.            editing functions.
  726.  
  727. ------------------------------
  728. S.24 - Floppy disk drive special file names.
  729.  
  730.       The floppy disk driver will attempt to discover what format the
  731.       diskette is in when reading.  When writing however, you must use
  732.       a matching device special file, or I/O errors will result.
  733.  
  734.       name          sect   trks  sides  size   description 
  735.       /dev/rfd#       15    80     2    1.2Mb  Normal High density
  736.       /dev/rfd#.9      9    40     2    360Kb  Double side, double density
  737.       /dev/rfd#.8      8    40     2    320Kb  Double side original PC
  738.       /dev/rfs#.9      9    40     1    180Kb  Single side, single density
  739.       /dev/rfs#.8      8    40     1    120Kb  Single side, original PC 64K
  740.  
  741. ------------------------------
  742. S.25 - Minidisk usage notes.
  743.  
  744.    * The number of minidisks is limited as follows:
  745.            max 64 minidisks per system
  746.            max 47 minidisks per disk unit
  747.  
  748.    * You can use the VRM Maintenance Facility (VMF) to repair a varity of 
  749.      minidisk problems.  It is described in the "AIX Problem Determination
  750.      Guide", appendix A.
  751.  
  752.    * If you have a minidisk that is on a disk that is a duplicate IODN number
  753.      the system will have problems determining which minidisk to use.
  754.  
  755.      To delete such a minidisk with VRM, do the following:
  756.  
  757.         - Boot with the VRM diskette.
  758.         - Take the option of the maintenance menu.
  759.         - Use the "qi" command and note the IODN of the minidisk, AND the
  760.           drive number, of which you want to delete.
  761.         - type "dlmd <iodn> <drive>" 
  762.            where <iodn> is the concerned IODN number.
  763.            and <drive> is the assocaited drive number. (1 thru 3)
  764.         - hit <F1>
  765.         - type "quit"
  766.  
  767. ------------------------------
  768. S.26 - How to add more pagespace and virtual memory.
  769.        Pagespace notes and a program to display usage.
  770.  
  771.      Using the VMF utilities (option 7 from the VRM install diskette's menu),
  772.      you can create additional minidisks and give them the "page space"
  773.      attribute.  This results in multiple paging space minidisks.
  774.      This is a simple way to increase paging space, and potentially can
  775.      help performance by splitting the paging I/O onto different controllers.
  776.      
  777.      NOTE: Pagespace minidisks cannot be on SCSI disks, as the SCSI drivers
  778.      are not loaded unitl after AIX is started.  As paging is performed
  779.      by VRM, all pagespace minidisks MUST be on the ESDI controllers, and
  780.      available at VRM boot time.
  781.  
  782.      WARNING: The location of the FIRST paging space minidisk is an attribute
  783.      set by VRM installation, and recorded in the VRM internals. Deleting
  784.      or moving this minidisk and recreating it on another drive will cause a
  785.      system abort at IPL time with a flashing c6-05.
  786.  
  787.    ==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==
  788.  
  789.    Here is a program I had in my archives that will display page space 
  790.    information and disk I/O statistics.  I compiled this as 'lsvm' lsvm.c
  791.  
  792. main()
  793. {
  794. volatile int *pages     = (int *) 0xb8;  /* page slots unallocated */
  795. volatile int *repcycles = (int *) 0xbc;  /* page replacement cycles */
  796. volatile int *iowaits   = (int *) 0xc0;  /* VM I/O waits            */
  797. volatile int *diskio    = (int *) 0xc4;  /* all non-paging disk I/O's   */
  798.  
  799.  printf(" %d = page slots unallocated\n",*pages);
  800.  printf(" %d = page replacement cycles\n",*repcycles);
  801.  printf(" %d = VM I/O waits\n",*iowaits);
  802.  printf(" %d = all non-paging disk I/O's\n",*diskio);
  803. }
  804.  
  805.    ==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==
  806.    Submitter: moody@austin.ibm.com
  807.    Subject: Re: Problems with swap space??
  808.    Summary: solution to avoid system crashes when your application runs.
  809.    Date: 27 Feb 90 22:19:01 GMT
  810.    Organization: IBM AWD, Austin, TX
  811.  
  812.    In article <728@duteca4.UUCP> mars@duteca.tudelft.nl () writes:
  813.    [much of article deleted]
  814.    >It seems to me that the problem is caused by a problem with the swap space,
  815.    >so I tried the program on the other RTs and it appeared that the same
  816.    >problem occured (although at least one of them didn't crash until at least
  817.    >one other extra application was running). I also tried the program on a
  818.    >SUN, but couldn't crash it.
  819.    >
  820.    >Maybe a larger swap space is the solution, but
  821.  
  822.    A larger swap space is the ultimate solution.
  823.  
  824.    >error message could be expected when too much memory has been allocated.
  825.  
  826.    AIX version 2 on the RT uses a delayed allocation scheme for
  827.    allocating paging slots to an application.  This may result in an
  828.    overcommitting of the page space on the RT for some applications which
  829.    use a lot of memory on a system with a small paging space.  One of our
  830.    vendors was the first we knew of to have the problem and I developed a
  831.    solution for them.  This solution is an easy way for developers to
  832.    port these large, memory consuming apps.  Applicationss originally
  833.    written for BSD systems seem to have this problem more often since BSD
  834.    does things differently.
  835.    
  836.    The following program fragment is my solution.
  837.  
  838. /* ----------------------- cut here --------------------------------*/
  839.  
  840. #define PAGESIZE 2048
  841. #define NULL 0
  842. #include <sys/signal.h>
  843. volatile int dangerflag;
  844. void free();
  845.  
  846. int main()
  847. {    int size, *ptr;
  848.     
  849.     void handler();
  850.     char *MALLOC();
  851.     
  852.     /* ensure your favorite program catches sigdanger */
  853.     signal(SIGDANGER,handler);
  854.     
  855.     /*************************************************************
  856.      your favorite memory hogging program which uses MALLOC to
  857.      allocate storage (not malloc)
  858.     *************************************************************/
  859.     size = ????;
  860.  
  861.     ptr = MALLOC(size);
  862.     ....
  863.     ....
  864.  
  865. }
  866.  
  867. void handler()
  868. {
  869.     /* sigdanger is sent when the number of paging slots drops
  870.     below the pswarn threshold (see /etc/master to tailor this).
  871.     Setting this threshold to a higher level may help
  872.     even if you don't use the rest of this solution. */
  873.  
  874.     dangerflag = 1;
  875. }
  876.  
  877. /* MAXMEMSIZE is chosen to be the largest real memory configuration
  878.    supported on the RT */
  879.  
  880. #define MAXMEMSIZE    0x1000000
  881.  
  882. /* MALLOC is used to overcome the possibility of overcommitting the
  883.    page space */
  884.  
  885. char *MALLOC(size)
  886. unsigned int size;
  887.  
  888. {
  889.     char    *malloc();
  890.     char    *p,*q;
  891.     int    i;
  892.     volatile int    *numps; /* number of paging slots from low memory */
  893.  
  894.     /* Make sure dangerflag is initialized */
  895.     dangerflag = 0;
  896.  
  897.     /* point to number of paging slots in AIX low memory */
  898.     numps = (int *)0xb8;
  899.  
  900.     /* ensure there is enough backing storage to back all of
  901.        memory (note MAXMEMSIZE is as good as I can get here: that
  902.        is, a lessor value wouldn't work on machines with less
  903.        memory */
  904.     if ((*numps * PAGESIZE) < (size + MAXMEMSIZE)) return((char*)NULL);
  905.  
  906.  
  907.     /* call the real malloc to get the storage */
  908.     q = p = malloc(size);
  909.     if (p == (char *)NULL) return(p);
  910.  
  911.     for(i = 0; i < size ; i += PAGESIZE)
  912.     {
  913.         /* touch and dirty the next page */
  914.         *q = 0;
  915.  
  916.         /* Get out if we went below the pswarn threshold */
  917.         if (dangerflag) goto getout;
  918.  
  919.         /* bump to the next page (note: must be careful to 
  920.            touch on the next page boundary and not in the
  921.            middle of the page */
  922.         q = (char *)(((int)q & (~(PAGESIZE-1))) + PAGESIZE); 
  923.     }
  924.  
  925.     /* ensure there is still enough backing storage */
  926.     if ((*numps * PAGESIZE) < (size + MAXMEMSIZE)) goto getout;
  927.     return(p);
  928.  
  929.  
  930.     getout: /* There isn't enough space available */
  931.     free(p);
  932.     return((char *)NULL);
  933. }
  934.  
  935. /* ------------------------- cut here -----------------------------*/
  936.  
  937.    Disclaimer:  The above program is already in the public domain and is posted
  938.    here without warranty (even though I know it works).
  939.    James Moody    Adv Workstations Div ; IBM Austin, 2502      
  940.         aesnet: moody@moody.austin.ibm.com
  941.         vnet: MOODY at AUSVM6
  942.    outside ->    ..!cs.utexas.edu!ibmchs!auschs!moody.austin.ibm.com!moody
  943.    ==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==**==
  944.  
  945. ------------------------------
  946. S.27 - ADDU setup and useage. 
  947.  
  948.      To use ADDU on PC/DOS systems, the RT needs the DOS Server program
  949.      (pci) lpp installed, and started from the /etc/rc.include startup script.
  950.  
  951.      [ I was requested to add this entry, but I have absolutely no 
  952.        experience with this product.  Open for some kind soul to fill
  953.        it in with knowledge.  - MW ]
  954.  
  955. ================================================================================
  956.                 *** FAQ Continued in software part 3 ***
  957. =============== end of ibm-rt-faq/aix-v2/software/part2 ========================
  958. -- 
  959.  
  960. Posted around the first of each month to comp.sys.ibm.pc.rt, and
  961. to comp.unix.aix.
  962.  
  963. This FAQ is dedicated to use of the AIX Version 2 operating system, running
  964. on the IBM RISC processor known as the RT.  The RT is known also as 
  965. an IBM model 6150 or 6151 machine.
  966.  
  967. For AIX RT  submissions E-mail to:   aix-rt@antimatr.hou.tx.us
  968. For AOS RT  submissions E-mail to:   aos-rt@antimatr.hou.tx.us
  969. For MACH RT submissions E-mail to:   mach-rt@antimatr.hou.tx.us
  970. For general Q&A submissions (hardware and other stuff) E-mail to:
  971.    faq-rt@antimatr.hou.tx.us
  972.  
  973. Other comments and correctons should be sent to the author:
  974.     Mark Whetzel
  975.     DOMAIN addr: markw@antimatr.hou.tx.us
  976.     BANG address:  ..!uhnix1!lobster!antimatr!markw
  977.     Daytime work number  8AM-5PM M-F CST  VOICE: (713) 963-2544
  978.  
  979. --
  980. AIX..... NOT just another UNIX. (tm)
  981. Mark Whetzel                          | My own RT system.. My own thoughts..
  982. DOMAIN: markw@antimatr.hou.tx.us      | IBM RT/135 running AIX 2.2.1 
  983. UUCP ..!menudo!lobster!antimatr!markw | comp.sys.ibm.pc.rt FAQ maintainer.
  984.